Gestenbereich-Widget

Pfad: Widget-Galerie> Schaltflächen> Andere

Das Gestenbereich-Widget ist eine HotSpot-Schaltfläche zur Erzeugung von Gestenereignissen.

 

Gestenereignisse Beschreibung

OnSwipeLeft

OnSwipeRight

Ein Ereignis wird ausgelöst, wenn die Swipe-Geste erkannt wird

OnPinchOpen

OnPinchClose

Ein Ereignis wird ausgelöst, wenn die Pinch-Geste erkannt wird

RotateClockwise

RotateAntiClockwise

Ein Ereignis wird ausgelöst, wenn die Drehungs-Geste erkannt wird

OnPan

OnPinch

OnRotate

Eine Reihe von Ereignissen, die während der Geste ausgelöst wurden.

Es kann nur JavaScript verwendet werden, um diese Ereignisse zu bedienen. Durch den JavaScript-Code kann der Entwickler die Gestenereignisse so verwalten, wie er es vorzieht.

WARNUNG: Nur auf Bediengeräten, die für die Mehrfingereingabe geeignet sind, können OnPinch- und OnRotate-Ereignisse generiert werden

OnPan

boolean onGesturePan(me, eventInfo)

Dieses Ereignis tritt auf, wenn ein Punkt innerhalb des Bereichs gedrückt und eine Bewegung festgestellt wird.

Parameter Beschreibung
me Objekt, welches das Ereignis auslöst.
Ereignisinformationen

id = Gesten-ID; wird verwendet, um unterschiedliche Gesten zu identifizieren.

running = True, außer für das letzte bereitgestellte Ereignis zur Anzeige des Gesten-Abschlusses.

dx = Gesamtbewegung auf der X-Achse in Bildschirmpixel von der ursprünglichen Touchposition.

dy = Gesamtbewegung auf der Y-Achse in Bildschirmpixel von der ursprünglichen Touchposition.

OnPinch

boolean onGesturePinch(me, eventInfo)

Dieses Ereignis tritt auf, wenn zwei Punkte innerhalb des Bereichs gedrückt wurden und eine Bewegung festgestellt wurde.

Parameter Beschreibung
me Objekt, welches das Ereignis auslöst
Ereignisinformationen

id = Gesten-ID; wird verwendet, um unterschiedliche Gesten zu identifizieren.

running = True, außer für das letzte bereitgestellte Ereignis zur Anzeige des Gesten-Abschlusses.

dx = Gesamtbewegung auf der X-Achse in Bildschirmpixel von der ursprünglichen Touchposition. Steht für die Veränderung des Abstandes zwischen den Fingern. Ein positiver Wert bedeutet, dass sich der Abstand erhöht; ein negativer Wert bedeutet, dass sich der Abstand verringert. Dieser Wert kann verwendet werden, um einen Zoom-Wert zu steuern.

dy = Gesamtbewegung auf der Y-Achse in Bildschirmpixel (siehe dx).

OnRotate

boolean onGestureRotate(me, eventInfo)

Dieses Ereignis tritt auf, wenn zwei Punkte innerhalb des Bereichs gedrückt wurden und eine rotierende Bewegung festgestellt wurde.

Parameter Beschreibung
me Objekt, welches das Ereignis auslöst
Ereignisinformationen

id = Gesten-ID; wird verwendet, um unterschiedliche Gesten zu identifizieren.

running = True, außer für das letzte bereitgestellte Ereignis zur Anzeige des Gesten-Abschlusses.

drot = Wieviel Grad (0/360) wurden seit dem vorhergehenden Ereignis hinzugefügt.

trot = Gesamtdrehung (0/360) der vollständigen Bewegung.

Positive Zahlen stehen für Drehungen im Uhrzeigersinn, negative für Drehungen entgegen dem Uhrzeigersinn.

Gestenereignisse gehen durch

Zur Nutzung eines Widgets (z. B eine Taste oder Slider), das von einem Gestenobjekt abgedeckt ist, müssen Sie das Widget 200 ms gedrückt halten, um das Steuerelement zum darunter liegenden Objekt zu verschieben. Die Zeit, die Sie warten müssen um den Befehl an das darunter liegende Objekt zu senden, kann über den Parameter "Gesture Passthru Delay" geändert werden, der in der Ansicht der erweiterten Eigenschaften verfügbar ist.

Parameter Beschreibung
Gesture Passthru aktiviert

Aktiviert die Möglichkeit, Gestenereignisse zu darunter liegenden Widgets nach einer konfigurierbaren Verzögerung zu übergeben. Der Benutzer muss den Finger gedrückt halten und dann die Geste ausführen.

default = Verwendet den in den Projekteigenschaften definierten Wert. Siehe "Projekt"

true = Gesture Passthru aktiviert

false = Gesture Passthru deaktiviert

Gesture Passthru Verzögerung (ms)

Die Zeit, die Sie warten müssen um den Befehl an das darunter liegende Objekt zu senden

0/500 mSek
-1 Verwendet die in den Projekteigenschaften definierte Verzögerung. Siehe "Projekt"
Beispiele für die Verwendung von Gestenereignissen in Verbindung mit JavaScript

Hier einige Beispiele für die Verwendung von Gestenereignissen in Verbindung mit JavaScript-Code, um Gesten zu identifizieren und die gewünschten Aktionen zu programmieren

Swipe-Geste

So erkennt man eine „Swipe“-Geste zum Wechseln einer Seite in der Anwendung.

  1. Platzieren Sie ein Gestenbereichs-Widget auf der Seite
  2. Konfigurieren Sie die Aktion OnPan, um eine JavaScript-Funktion auszulösen
  3. Schreiben Sie den JavaScript-Code zur Erkennung und Verwaltung der Swipe-Geste

Pinch-Geste

Wie man eine "Pinch" -Geste zur Größenänderung eines Bildes erkennt.

  1. Platzieren Sie ein Gestenbereichs-Widget auf der Seite über das Bild
  2. Konfigurieren Sie die Aktion OnPinch, um eine JavaScript-Funktion auszulösen
  3. Schreiben Sie den JavaScript-Code zur Erkennung und Verwaltung der Pinch-Geste

Pan Geste

Wie man eine "Pan"-Geste zur Größenänderung eines Bildes erkennt.

  1. Platzieren Sie ein Gestenbereichs-Widget auf der Seite über das Bild
  2. Konfigurieren Sie die Aktion OnPan, um eine JavaScript-Funktion auszulösen
  3. Schreiben Sie den JavaScript-Code zur Erkennung und Verwaltung der Pan-Geste